home *** CD-ROM | disk | FTP | other *** search
/ Massive MOD Collection / Massive MOD Collection.iso / player_3 / vpeng.doc < prev    next >
Text File  |  1992-10-26  |  11KB  |  285 lines
  1. Visual Player
  2. Version 1.1, Barcelona, October '92
  3. Player & FFT by Héctor Martínez
  4. Graphics & program by Luis Crespo
  5. Sound Blaster Pro by David López & Angel Trigo.
  6.  
  7. Visual Player is a graphic MOD player.
  8. While the music is playing, Visual Player can display the waveform of the
  9. four voices of the MOD, the final waveform, four real volume bars, and a
  10. realtime spectrum analyzer. This program has been made to "look" at the
  11. music while you listen to it. Everything in Visual Player is real,
  12. everything that is displayed is calculated from the digital data and not
  13. from the score.
  14.  
  15.  
  16. How to use VP:
  17. --------------
  18. To run Visual Player, you must enter:
  19.  
  20.    VP modname
  21.  
  22. At the DOS command prompt, where "modname" is the name of the MOD file you
  23. want to listen to. You can use wildcards when specifying the file name, for
  24. example:
  25.  
  26.    VP a*
  27.  
  28. Will play all the MOD files that start with "a".
  29.  
  30.  
  31. Hardware requirements:
  32. ----------------------
  33. VP can play music through the internal PC speaker, the Sound Blaster card,
  34. the Sound Blaster Pro card, or one or two digital to analog converters (DAC)
  35. connected to the printer ports, LPT1 and LPT2. It is very cheap and easy to
  36. build a DAC and plug it on the printer port. A simple circuit design is
  37. given below.
  38.  
  39. VP needs a VGA card, and because of the graphic features of the program,
  40. the faster the computer is, the better VP will run. If you have already
  41. tried the program and the display is too slow, you will have to modify the
  42. VP.CFG file and turn off some graphic features or decrease the sampling
  43. frequency. It is recommendable to read VP.CFG anyway, because it has some
  44. important additional information.
  45.  
  46. VP does not need a lot of memory to run, but some MOD files are very big
  47. and then a lot of memory will be needed. If there is not enough memory once
  48. a MOD file is loaded, the help screen and the OS Shell will not work.
  49.  
  50. It is better not to use programs and drivers that leave the 386 in virtual
  51. mode, like EMM386, QEMM, 386MAX, etc, because they slow down the computer
  52. and they decrease the sound quality. This is more important if you have a
  53. slow 386 or a SB or a SB Pro.
  54.  
  55.  
  56. The Keys:
  57. ---------
  58. Here is a quick keyboard reference for the impatient people:
  59.  
  60.  
  61.         PgUp     : Decrement Pattern
  62.         PgDown   : Increment Pattern
  63.  
  64.         +        : Increment Sampling Frequency
  65.         -        : Decrement Sampling Frequency
  66.  
  67.         P        : Change Playing Device
  68.         F        : Toggle Sound Blaster Pro Filter
  69.  
  70.         1..4     : Toggle Voice
  71.  
  72.         F1..F5   : Toggle Oscilloscope
  73.         SF1..SF5 : Toggle Oscilloscope Wave Sync
  74.  
  75.         F6       : Toggle Spectrum Analyzer
  76.         L        : Toggle Spectrum Logarithmic Scale
  77.         M        : Toggle Spectrum FFT Method
  78.  
  79.         F7       : Toggle Volume Bars
  80.  
  81.         S        : OS Shell
  82.         Enter    : Next MOD / Quit Visual Player
  83.         ESC      : Quit Visual Player
  84.  
  85.         F9       : Help screen
  86.  
  87.  
  88. The mixing frequency:
  89. ---------------------
  90. The mixing frequency, also called sampling frequency or sampling rate, is
  91. the speed at which the sound is processed. That means that the higher the
  92. sampling frequency, the better the quality of the sound, especially with
  93. the high pitched sounds like charles, bells, etc. A fast machine will allow
  94. a faster sampling frequency. If you have a slow machine and run the program
  95. with a high sampling frequency, the graphic display will slow down. Also if
  96. you decrease the sampling frequency under 13 Khz, the oscilloscopes will
  97. display trash.
  98.  
  99. The oscilloscopes:
  100. ------------------
  101. The 4 upper oscilloscopes display the waveform of the voices that are being
  102. played, and the central oscilloscope displays the sum of the 4 voices. The
  103. graphs can be synchronized with the beginning of the waveform, so that in
  104. most of the cases the waveform will be displayed at the same place. If you
  105. have a stereo output, like an SB Pro, you will see that the voices 1 and 4
  106. sound through the left channel, and the voices 2 and 3 sound through the
  107. right channel. If you have built your own stereo DAC, we recommend you that
  108. you put the output cables following this criterion, so that the volume bars
  109. display will be coherent.
  110.  
  111. The volume bars:
  112. ----------------
  113. The volume bars are located at each side of the central oscilloscope, and
  114. are placed so that the voices that sound through the left channel, voices
  115. 1 and 4, are at the left side of the oscilloscope, and the voices that
  116. sound through the right channel, voices 2 and 3, are at the right side of
  117. the oscilloscope.
  118.  
  119. The spectrum analyzer:
  120. ----------------------
  121. The spectrum analyzer is the most time-consuming feature of the program. It
  122. displays the power of each frequency in the sound. The spectrum analyzer is
  123. implemented with an FFT algorithm with integer arithmetic. The FFT is
  124. calculated from 128 samples taken from a buffer that sounds during a 1/50th
  125. of second, so that the first spectrum bar shows the power of F=0 Hz, the
  126. second shows F=50 Hz, the third F=100 Hz, the fourth F=150 Hz, and so on,
  127. independently of the mixing frequency. That stands for method number 1.
  128. Method number 2 takes 64 samples from the buffer and shows half the bars of
  129. method number 1, so it is faster but less accurate than method number 1.
  130. Method number 3 is an hybrid of 1 and 2: it takes 64 samples and fills the
  131. other 64 with zeroes, so every bar takes 25 Hz.
  132.  
  133. The programmer of a famous Mod Player, says in his docs that his program is
  134. the only one that implements a realtime spectrum analyzer. That was not
  135. true when he programmed his spectrum analyzer, because it already existed
  136. TrakBlaster 2.0, but now it will be less true. And the spectrum analyzer
  137. routines are ours, we have not taken them from anywhere.
  138.  
  139.  
  140. New in Version 1.1:
  141. -------------------
  142. We have released version 1.1 to correct some bugs version 1.0 had. The
  143. corrections of previous version are:
  144.  
  145. - Added code to control if the SB buffer goes in two DMA pages.
  146. - When toggling the SB Pro filter, the left and right channels do not
  147.   interchange.
  148. - When pressing Ctrl-Break, it does not exit to DOS without closing the
  149.   program.
  150. - It doesn't hang when pressing Pg Down at the last sequence of the MOD.
  151. - It doesn't make a popping sound any more between MOD files, with SB
  152.   and SB Pro.
  153. - When making an OS Shell, changing the directory, and going back to VP,
  154.   MOD files still can be loaded.
  155. - Minor corrections in the player.
  156. - The program does not need the file VP.PIC any more, because the screen
  157.   is drawn at run time.
  158. - Nicer help screen.
  159.  
  160.  
  161. Next versions:
  162. --------------
  163. In the next versions, our program will have:
  164.  
  165. - Mouse support.
  166. - SB Pro Mixer control.
  167. - MOD title display, instruments display, total MOD time display, etc.
  168. - Stereo-in-One support.
  169. - Sound Blaster 3.0 support, if we get one of those cards.
  170. - Other sound cards support, as soon as somebody "donates" us some of those
  171.   cards for testing and programming.
  172. - File selection menu.
  173. - "Juke Box" mode: you will be able to listen sequentially to the MOD files
  174.   listed in a file.
  175.  
  176.  
  177. Credits:
  178. --------
  179. Greetings go to:
  180.  
  181. Juan Carlos Arévalo, Victor Neira, Manolo Ruiz Moscoso, Juan Pedro Teruel,
  182. Hakan Gustavsson (The CodeBlasters, Sweden), James Chow (SBNet, Canada),
  183. Xavier Mundó Balcells (For the ARJ comment screen).
  184.  
  185. ...And all the beta testers that have been evaluating the program.
  186.  
  187.  
  188. Shareware:
  189. ----------
  190. Visual Player is distributed as shareware. If you have obtained VP from a
  191. friend, a BBS or similar source, you have an unregistered version. In the
  192. unregistered version a reminding text appears from time to time at the most
  193. interesting parts of the screen.
  194.  
  195. When you register, you get:
  196. - A 3'5", 720 KB diskette with a copy of the latest version of VP registered
  197.   to you, without the annoying texts of the unregistered version.
  198. - Free next version registration.
  199. - Due notice of every new version.
  200. - The MOD files that you choose from the list that come with the program:
  201.   MODS.LST.  (All only in one diskette)
  202.  
  203. To register, send a letter to:
  204.  
  205.    Luis Crespo
  206.    P.O. Box 93142
  207.    08080 Barcelona, SPAIN
  208.  
  209. With your full name and address and 3.000 Ptas if you live in Spain, or $35
  210. if you live outside Spain.
  211.  
  212. You can also register of only one version, by sending 1.500 Ptas if you
  213. live in Spain, or $20 if you live outside Spain. In such a case you will
  214. not get the next registered version.
  215.  
  216.  
  217. Copyright/License/Warranty:
  218. ---------------------------
  219. Visual Player must be distributed unmodified and with its full
  220. documentation and files. The registered version must not be distributed.
  221.  
  222. Visual Player is copyright of the authors. The authors allow to: use
  223. software, make copies of it, give copies to anybody and distribute it
  224. through electronic media.
  225.  
  226. It is not allowed to ask for money or donations for any copy or copies of
  227. the program, neither distribute the software and/or documentation with
  228. commercial products, without previous written acknowledgement of the
  229. authors.
  230.  
  231. There is not warranty of any kind, and the authors are not responsible for
  232. any kind of damage that the use of the software may cause. When using this
  233. software, you agree with everything written above.
  234.  
  235.  
  236. How to contact the authors:
  237. ---------------------------
  238. We are waiting for your comments and opinions about our program. Our
  239. electronic addresses are:
  240.  
  241. Luis Crespo: FidoNet 2:343/108.21
  242. Angel Trigo: Fidonet 2:343/121.242
  243.  
  244. The circuit:
  245. ------------
  246. And here it is the circuit: a Digital to Analog Converter that plugs into
  247. the printer port and to the amplifier. To build it, you will just need 18 1%
  248. resistors, 2 capacitors, a male D-25 connector, and a jack. It is very
  249. important that the resistors have 1% tolerance, because if they have 5% or
  250. more, the thing will sound like hell.
  251.  
  252.  
  253.           Printer Port
  254.  
  255.           signal   pin
  256.                               20k   20k
  257.           D0       2      >───░░░─┬─░░░──0v (GND, pin 20)
  258.                               20k ░ 10k
  259.           D1       3      >───░░░─┤
  260.                               20k ░ 10k
  261.           D2       4      >───░░░─┤
  262.                               20k ░ 10k
  263.           D3       5      >───░░░─┤
  264.                               20k ░ 10k
  265.           D4       6      >───░░░─┤
  266.                               20k ░ 10k
  267.           D5       7      >───░░░─┤
  268.                               20k ░ 10k
  269.           D6       8      >───░░░─┤
  270.                               20k ░ 10k
  271.           D7       9      >───░░░─┤
  272.                               20k ░ 10k  100nF
  273.                                   ├──────┤├─┬──> To Amplifier
  274.                                   │         │
  275.                                   ░ 10k     ┴ 10nF
  276.                                   │         ┬
  277.           GND      20     >───────┼─────────┴──>
  278.                                   0v
  279.  
  280.  
  281. This circuit is an enhancement of the one that came with Mark J.Cox ModPlay,
  282. so we thank Mark J.Cox for his original design.
  283.  
  284.  
  285.